home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-iafa-templates-00.txt < prev    next >
Text File  |  1993-08-17  |  15KB  |  572 lines
  1. INTERNET DRAFT                                               P. Deutsch
  2. Request for Comments: XXXX                                    A. Emtage
  3. FYI:XX                                                           Bunyip
  4. Expires: March 1, 1994
  5.                                                             August 1993
  6.  
  7.     Data Element Templates for Internet Information Objects
  8.  
  9.  
  10. Status of This Memo
  11.  
  12. This document is an Internet-Draft.  Internet-Drafts are working
  13. documents of the Internet Engineering Task Force (IETF), its Areas, and
  14. its Working Groups.  Note that other groups may also distribute working
  15. documents as Internet-Drafts.  Internet-Drafts are draft documents valid
  16. for a maximum of six months.  Internet-Drafts may be updated, replaced,
  17. or obsoleted by other documents at any time.  It is not appropriate to
  18. use Internet-Drafts as reference material or to cite them other than as a
  19. "working draft" or "work in progress."
  20.  
  21. Please send comments to Alan Emtage, bajan@bunyip.com
  22.  
  23.  
  24. ABSTRACT
  25.  
  26. This document describes full definitions of templates defined in the
  27. companion document "Publishing Information on the Internet with Anonymous
  28. FTP" [1] and are an initial attempt a providing a consistent naming
  29. scheme for indexing information for Internet information "objects" such
  30. as documents, services and site information.
  31.  
  32. ACKNOWLEDGEMENTS
  33.  
  34. This document is the result of work done in the Internet Anonymous FTP
  35. Archives (IAFA) working group of the IETF.  Special thanks are due to
  36. George Brett, Jill Foster, Jim Fullton, Kevin Gambiel, Joan Gargano,
  37. Rebecca Guenther, John Kunze, Clifford Lynch, Pete Percival, Paul Peters,
  38. Cecilia Preston, Peggy Seiden, Craig Summerhill, Chris Weider and Janet
  39. Vratney.
  40.  
  41. 1. INTRODUCTION
  42.  
  43. The templates in this document may, at first glance, appear to be very
  44. long and complicated. However, a closer inspection will reveal that this
  45. is in fact not the case and that there is a consistent, logical structure
  46. throughout. In many cases only a fraction of the data elements will need
  47. to be filled out to provide a useful entry in your publishing
  48. environment, be it an anonymous FTP server or other forum. Many of the
  49. repeated fields can be eliminated with the judicious use of USER or
  50. ORGANIZATION templates. This document does not describe the valid range
  51. of values for each data element. These are listed in [1] and users should
  52. consult that document for futher information and examples.
  53.  
  54.  
  55. 2. TEMPLATE DEFINITIONS
  56.  
  57. 2.1 The USER template
  58.  
  59. The USER template is defined below.
  60.  
  61. Name:
  62. Organization-Name:
  63. Organization-Type:
  64. Work-Phone:
  65. Work-Fax:
  66. Work-Postal:
  67. Job-Title:
  68. Department:
  69. Email:
  70. Handle:
  71. Home-Phone:
  72. Home-Postal:
  73. Home-Fax:
  74.  
  75. 2.2 The ORGANIZATION Template
  76.  
  77. The full ORGANIZATION template definition is given below.
  78.  
  79. Organization-Name:
  80. Organization-Type:    
  81. Organization-Postal:
  82. Organization-City:
  83. Organization-State:
  84. Organization-Country:
  85. Organization-Email:
  86. Organization-Phone:
  87. Organization-Fax:
  88. Organization-Handle:
  89.  
  90. 2.3 SITEINFO Template
  91.  
  92. This is the full definition for the SITEINFO template.
  93.  
  94. Template-Name:    SITEINFO
  95. Host-Name:        
  96. City:
  97. Country:
  98. State:
  99. Access-Policy:
  100. Access-Times:
  101. Admin-Department:
  102. Admin-Email:
  103. Admin-Handle:
  104. Admin-Home-Fax:
  105. Admin-Home-Phone:
  106. Admin-Home-Postal:
  107. Admin-Job-Title:
  108. Admin-Name:
  109. Admin-Organization-Name:                
  110. Admin-Organization-Type:
  111. Admin-Work-Fax:
  112. Admin-Work-Phone:
  113. Admin-Work-Postal:
  114. Alias:
  115. Description:
  116. Keywords:
  117. Latitude-Longitude:
  118. Owner-Organization-City:
  119. Owner-Organization-Country:
  120. Owner-Organization-Email:
  121. Owner-Organization-Fax:
  122. Owner-Organization-Handle:
  123. Owner-Organization-Name:
  124. Owner-Organization-Phone:
  125. Owner-Organization-Postal:
  126. Owner-Organization-State:
  127. Owner-Organization-Type:
  128. Record-Last-Modified-Date:
  129. Record-Last-Modified-Department:
  130. Record-Last-Modified-Email:
  131. Record-Last-Modified-Handle:
  132. Record-Last-Modified-Home-Fax:
  133. Record-Last-Modified-Home-Phone:
  134. Record-Last-Modified-Home-Postal:
  135. Record-Last-Modified-Job-Title:
  136. Record-Last-Modified-Name:
  137. Record-Last-Modified-Organization-Name:                
  138. Record-Last-Modified-Organization-Type:
  139. Record-Last-Modified-Work-Fax:
  140. Record-Last-Modified-Work-Phone:
  141. Record-Last-Modified-Work-Postal:
  142. Record-Last-Verified-Department:
  143. Record-Last-Verified-Email:
  144. Record-Last-Verified-Handle:
  145. Record-Last-Verified-Home-Fax:
  146. Record-Last-Verified-Home-Phone:
  147. Record-Last-Verified-Home-Postal:
  148. Record-Last-Verified-Job-Title:
  149. Record-Last-Verified-Name:
  150. Record-Last-Verified-Organization-Name:                
  151. Record-Last-Verified-Organization-Type:
  152. Record-Last-Verified-Work-Fax:
  153. Record-Last-Verified-Work-Phone:
  154. Record-Last-Verified-Work-Postal:
  155. Sponsoring-Organization-City:
  156. Sponsoring-Organization-Country:
  157. Sponsoring-Organization-Email:
  158. Sponsoring-Organization-Fax:
  159. Sponsoring-Organization-Handle:
  160. Sponsoring-Organization-Name:
  161. Sponsoring-Organization-Phone:
  162. Sponsoring-Organization-Postal:
  163. Sponsoring-Organization-State:
  164. Sponsoring-Organization-Type:
  165. Timezone:
  166. Update-Frequency:
  167. Record-Last-Verified-Date:
  168.  
  169. 2.4 LARCHIVE Template
  170.  
  171. Below is the full definition for the LARCHIVE template.
  172.  
  173. Template-Type:        LARCHIVE
  174. Admin-Department:
  175. Admin-Email:
  176. Admin-Handle:
  177. Admin-Home-Fax:
  178. Admin-Home-Phone:
  179. Admin-Home-Postal:
  180. Admin-Job-Title:
  181. Admin-Name:
  182. Admin-Organization-Name:                
  183. Admin-Organization-Type:
  184. Admin-Work-Fax:
  185. Admin-Work-Phone:
  186. Admin-Work-Postal:
  187. Alias:
  188. Owner-Organization-City:
  189. Owner-Organization-Country:
  190. Owner-Organization-Email:
  191. Owner-Organization-Fax:
  192. Owner-Organization-Handle:
  193. Owner-Organization-Name:
  194. Owner-Organization-Phone:
  195. Owner-Organization-Postal:
  196. Owner-Organization-State:
  197. Owner-Organization-Type:
  198. Sponsoring-Organization-City:
  199. Sponsoring-Organization-Country:
  200. Sponsoring-Organization-Email:
  201. Sponsoring-Organization-Fax:
  202. Sponsoring-Organization-Handle:
  203. Sponsoring-Organization-Name:
  204. Sponsoring-Organization-Phone:
  205. Sponsoring-Organization-Postal:
  206. Sponsoring-Organization-State:
  207. Sponsoring-Organization-Type:
  208. Record-Last-Modified-Date:
  209. Record-Last-Modified-Department:
  210. Record-Last-Modified-Email:
  211. Record-Last-Modified-Handle:
  212. Record-Last-Modified-Home-Fax:
  213. Record-Last-Modified-Home-Phone:
  214. Record-Last-Modified-Home-Postal:
  215. Record-Last-Modified-Job-Title:
  216. Record-Last-Modified-Name:
  217. Record-Last-Modified-Organization-Name:                
  218. Record-Last-Modified-Organization-Type:
  219. Record-Last-Modified-Work-Fax:
  220. Record-Last-Modified-Work-Phone:
  221. Record-Last-Modified-Work-Postal:
  222. Record-Last-Verified-Department:
  223. Record-Last-Verified-Email:
  224. Record-Last-Verified-Handle:
  225. Record-Last-Verified-Home-Fax:
  226. Record-Last-Verified-Home-Phone:
  227. Record-Last-Verified-Home-Postal:
  228. Record-Last-Verified-Job-Title:
  229. Record-Last-Verified-Name:
  230. Record-Last-Verified-Organization-Name:                
  231. Record-Last-Verified-Organization-Type:
  232. Record-Last-Verified-Work-Fax:
  233. Record-Last-Verified-Work-Phone:
  234. Record-Last-Verified-Work-Postal:
  235. Access-Policy:
  236. Description:
  237. Update-Frequency:
  238. Keywords:
  239.  
  240. 2.5 SERVICES Template
  241.  
  242. The full SERVICES template is given below. Note that a "service"
  243. is defined to include mailing lists, video and sound feeds and other
  244. forms of interactive information sources on the network.
  245.  
  246. Template-Type:        SERVICES
  247. Name:
  248. Host-Name:
  249. Host-Port:
  250. Protocol:
  251. Admin-Department:
  252. Admin-Email:
  253. Admin-Handle:
  254. Admin-Home-Fax:
  255. Admin-Home-Phone:
  256. Admin-Home-Postal:
  257. Admin-Job-Title:
  258. Admin-Name:
  259. Admin-Organization-Name:                
  260. Admin-Organization-Type:
  261. Admin-Work-Fax:
  262. Admin-Work-Phone:
  263. Admin-Work-Postal:
  264. Admin-Organization-Postal:
  265. Admin-Organization-City:
  266. Admin-Organization-State:
  267. Admin-Organization-Country:
  268. Admin-Organization-Email:
  269. Admin-Organization-Phone:
  270. Admin-Organization-Fax:
  271. Admin-Organization-Handle:
  272. Sponsoring-Organization-City:
  273. Sponsoring-Organization-Country:
  274. Sponsoring-Organization-Email:
  275. Sponsoring-Organization-Fax:
  276. Sponsoring-Organization-Handle:
  277. Sponsoring-Organization-Name:
  278. Sponsoring-Organization-Phone:
  279. Sponsoring-Organization-Postal:
  280. Sponsoring-Organization-State:
  281. Sponsoring-Organization-Type:
  282. Description:
  283. Authentication:
  284. Registration:
  285. Charging-Policy:
  286. Access-Policy:
  287. Access-Times:
  288. Keywords:
  289. Record-Last-Modified-Date:
  290. Record-Last-Modified-Department:
  291. Record-Last-Modified-Email:
  292. Record-Last-Modified-Handle:
  293. Record-Last-Modified-Home-Fax:
  294. Record-Last-Modified-Home-Phone:
  295. Record-Last-Modified-Home-Postal:
  296. Record-Last-Modified-Job-Title:
  297. Record-Last-Modified-Name:
  298. Record-Last-Modified-Organization-Name:                
  299. Record-Last-Modified-Organization-Type:
  300. Record-Last-Modified-Work-Fax:
  301. Record-Last-Modified-Work-Phone:
  302. Record-Last-Modified-Work-Postal:
  303. Record-Last-Verified-Department:
  304. Record-Last-Verified-Email:
  305. Record-Last-Verified-Handle:
  306. Record-Last-Verified-Home-Fax:
  307. Record-Last-Verified-Home-Phone:
  308. Record-Last-Verified-Home-Postal:
  309. Record-Last-Verified-Job-Title:
  310. Record-Last-Verified-Name:
  311. Record-Last-Verified-Organization-Name:                
  312. Record-Last-Verified-Organization-Type:
  313. Record-Last-Verified-Work-Fax:
  314. Record-Last-Verified-Work-Phone:
  315. Record-Last-Verified-Work-Postal:
  316. Record-Last-Verified-Date:
  317.  
  318. 2.6 DOCUMENT, IMAGE and SOUND Templates
  319.  
  320. This template defines the data elements for the DOCUMENT, IMAGE and SOUND
  321. template types and the Template-Type field here can be any one of those
  322. values.
  323.  
  324. Template-Type:        (any one of DOCUMENT, IMAGE or SOUND)
  325. Category:
  326. Title:
  327. Author-Name:
  328. Author-Organization-Name:
  329. Author-Organization-Type:
  330. Author-Work-Phone:
  331. Author-Work-Fax:
  332. Author-Work-Postal:
  333. Author-Job-Title:
  334. Author-Department:
  335. Author-Email:
  336. Author-Handle:
  337. Author-Home-Phone:
  338. Author-Home-Postal:
  339. Author-Home-Fax:
  340. Record-Last-Modified-Date:
  341. Record-Last-Modified-Department:
  342. Record-Last-Modified-Email:
  343. Record-Last-Modified-Handle:
  344. Record-Last-Modified-Home-Fax:
  345. Record-Last-Modified-Home-Phone:
  346. Record-Last-Modified-Home-Postal:
  347. Record-Last-Modified-Job-Title:
  348. Record-Last-Modified-Name:
  349. Record-Last-Modified-Organization-Name:                
  350. Record-Last-Modified-Organization-Type:
  351. Record-Last-Modified-Work-Fax:
  352. Record-Last-Modified-Work-Phone:
  353. Record-Last-Modified-Work-Postal:
  354. Record-Last-Verified-Department:
  355. Record-Last-Verified-Email:
  356. Record-Last-Verified-Handle:
  357. Record-Last-Verified-Home-Fax:
  358. Record-Last-Verified-Home-Phone:
  359. Record-Last-Verified-Home-Postal:
  360. Record-Last-Verified-Job-Title:
  361. Record-Last-Verified-Name:
  362. Record-Last-Verified-Organization-Name:                
  363. Record-Last-Verified-Organization-Type:
  364. Record-Last-Verified-Work-Fax:
  365. Record-Last-Verified-Work-Phone:
  366. Record-Last-Verified-Work-Postal:
  367. Record-Last-Verified-Date:
  368. Version:
  369. Source:
  370. Requirements:
  371. Description:
  372. Bibliography:
  373. Citation:
  374. Publication-Status:
  375. Publisher-Organization-City:
  376. Publisher-Organization-Country:
  377. Publisher-Organization-Email:
  378. Publisher-Organization-Fax:
  379. Publisher-Organization-Handle:
  380. Publisher-Organization-Name:
  381. Publisher-Organization-Phone:
  382. Publisher-Organization-Postal:
  383. Publisher-Organization-State:
  384. Publisher-Organization-Type:
  385. Copyright:
  386. Creation-Date:
  387. Discussion:
  388. Keywords:
  389. Format-v*:
  390. Size-v*:
  391. Language-v*:
  392. Character-Set-v*:
  393. ISBN-v*:
  394. ISSN-v*:
  395. Access-Protocol-v*:
  396. Access-Host-Name-v*:
  397. Access-Host-Port-v*:
  398. Pathname-v*:
  399. Last-Revision-Date-v*:
  400. Library-Catalog-v*:
  401.  
  402. 2.7 SOFTWARE Template
  403.  
  404. The template definition for software packages is defined below.
  405.  
  406. Template-Type:        SOFTWARE
  407. Category:    
  408. Title:
  409. Author-Name:
  410. Author-Organization-Name:
  411. Author-Organization-Type:
  412. Author-Work-Phone:
  413. Author-Work-Fax:
  414. Author-Work-Postal:
  415. Author-Job-Title:
  416. Author-Department:
  417. Author-Email:
  418. Author-Handle:
  419. Author-Home-Phone:
  420. Author-Home-Postal:
  421. Author-Home-Fax:
  422. Admin-Department:
  423. Admin-Email:
  424. Admin-Handle:
  425. Admin-Home-Fax:
  426. Admin-Home-Phone:
  427. Admin-Home-Postal:
  428. Admin-Job-Title:
  429. Admin-Name:
  430. Admin-Organization-Name:                
  431. Admin-Organization-Type:
  432. Admin-Work-Fax:
  433. Admin-Work-Phone:
  434. Record-Last-Modified-Date:
  435. Record-Last-Modified-Department:
  436. Record-Last-Modified-Email:
  437. Record-Last-Modified-Handle:
  438. Record-Last-Modified-Home-Fax:
  439. Record-Last-Modified-Home-Phone:
  440. Record-Last-Modified-Home-Postal:
  441. Record-Last-Modified-Job-Title:
  442. Record-Last-Modified-Name:
  443. Record-Last-Modified-Organization-Name:                
  444. Record-Last-Modified-Organization-Type:
  445. Record-Last-Modified-Work-Fax:
  446. Record-Last-Modified-Work-Phone:
  447. Record-Last-Modified-Work-Postal:
  448. Record-Last-Verified-Department:
  449. Record-Last-Verified-Email:
  450. Record-Last-Verified-Handle:
  451. Record-Last-Verified-Home-Fax:
  452. Record-Last-Verified-Home-Phone:
  453. Record-Last-Verified-Home-Postal:
  454. Record-Last-Verified-Job-Title:
  455. Record-Last-Verified-Name:
  456. Record-Last-Verified-Organization-Name:                
  457. Record-Last-Verified-Organization-Type:
  458. Record-Last-Verified-Work-Fax:
  459. Record-Last-Verified-Work-Phone:
  460. Record-Last-Verified-Work-Postal:
  461. Record-Last-Verified-Date:
  462. Version:
  463. Source:
  464. Requirements:
  465. Description:
  466. Bibliography:
  467. Citation:
  468. Publication-Status:
  469. Publisher-Organization-City:
  470. Publisher-Organization-Country:
  471. Publisher-Organization-Email:
  472. Publisher-Organization-Fax:
  473. Publisher-Organization-Handle:
  474. Publisher-Organization-Name:
  475. Publisher-Organization-Phone:
  476. Publisher-Organization-Postal:
  477. Publisher-Organization-State:
  478. Copyright:
  479. Creation-Date:
  480. Discussion:
  481. Keywords:
  482. Format-v*:
  483. Size-v*:
  484. Language-v*:
  485. Character-Set-v*:
  486. Access-Protocol-v*:
  487. Access-Host-Name-v*:
  488. Access-Host-Port-v*:
  489. Pathname-v*:
  490. Last-Revision-Date-v*:
  491.  
  492. 2.8 MAILARCHIVE and USENET Templates
  493.  
  494. The full template definition for MAILARCHIVE or USENET templates.
  495.  
  496. Template-Type:    (either one of MAILARCHIVE or USENET)
  497. Title:
  498. Admin-Department:
  499. Admin-Email:
  500. Admin-Handle:
  501. Admin-Home-Fax:
  502. Admin-Home-Phone:
  503. Admin-Home-Postal:
  504. Admin-Job-Title:
  505. Admin-Name:
  506. Admin-Organization-Name:                
  507. Admin-Organization-Type:
  508. Admin-Work-Fax:
  509. Admin-Work-Phone:
  510. Record-Last-Modified-Date:
  511. Record-Last-Modified-Department:
  512. Record-Last-Modified-Email:
  513. Record-Last-Modified-Handle:
  514. Record-Last-Modified-Home-Fax:
  515. Record-Last-Modified-Home-Phone:
  516. Record-Last-Modified-Home-Postal:
  517. Record-Last-Modified-Job-Title:
  518. Record-Last-Modified-Name:
  519. Record-Last-Modified-Organization-Name:                
  520. Record-Last-Modified-Organization-Type:
  521. Record-Last-Modified-Work-Fax:
  522. Record-Last-Modified-Work-Phone:
  523. Record-Last-Modified-Work-Postal:
  524. Record-Last-Verified-Department:
  525. Record-Last-Verified-Email:
  526. Record-Last-Verified-Handle:
  527. Record-Last-Verified-Home-Fax:
  528. Record-Last-Verified-Home-Phone:
  529. Record-Last-Verified-Home-Postal:
  530. Record-Last-Verified-Job-Title:
  531. Record-Last-Verified-Name:
  532. Record-Last-Verified-Organization-Name:                
  533. Record-Last-Verified-Organization-Type:
  534. Record-Last-Verified-Work-Fax:
  535. Record-Last-Verified-Work-Phone:
  536. Record-Last-Verified-Work-Postal:
  537. Record-Last-Verified-Date:
  538. Description:
  539. Publisher-Organization-City:
  540. Publisher-Organization-Country:
  541. Publisher-Organization-Email:
  542. Publisher-Organization-Fax:
  543. Publisher-Organization-Handle:
  544. Publisher-Organization-Name:
  545. Publisher-Organization-Phone:
  546. Publisher-Organization-Postal:
  547. Publisher-Organization-State:
  548. Copyright:
  549. Creation-Date:
  550. Discussion:
  551. Keywords:
  552. Language-v*:
  553. Character-Set-v*:
  554. Access-Protocol-v*:
  555. Access-Host-Name-v*:
  556. Pathname-v*:
  557.  
  558.       
  559. 3. CONCLUSION
  560.  
  561. The templates defined in this document are intended to aid users and
  562. administrators in creating IAFA files for publishing information in the
  563. Internet environment. It is expected that this document will be revised
  564. on a regular basis as the experience gained in using this initial set
  565. steers the community to a more useful and efficient publishing model.
  566.  
  567. BIBLIOGRAPHY
  568.  
  569. [1] Internet Draft "Publishing Information on the Internet with Anonymous
  570.     FTP". Work in progress from the Internet Anonymous FTP Archive
  571.     Working Group of the IETF.
  572.